> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Obter metadados de blobs do Title Storage

> Exemplo de código C simples para recuperar metadados de blobs do Title Storage do XBOX com XblTitleStorageGetBlobMetadataAsync, incluindo a paginação por identificadores de resultado.

Este tópico demonstra como recuperar metadados de blobs do Title Storage do XBOX usando os exemplos de código C simples a seguir.

#### C simples

```cpp theme={null}
auto asyncBlock = std::make_unique<XAsyncBlock>();
asyncBlock->queue = queue;
asyncBlock->context = nullptr;
asyncBlock->callback = [](XAsyncBlock* asyncBlock)
{
    std::unique_ptr<XAsyncBlock> asyncBlockPtr{ asyncBlock };
    XblTitleStorageBlobMetadataResultHandle handle;
    HRESULT hr = XblTitleStorageGetBlobMetadataResult(asyncBlock, &handle);

    if (SUCCEEDED(hr))
    {
        if (blobMetadataResultHandle != nullptr)
        {
            XblTitleStorageBlobMetadataResultCloseHandle(blobMetadataResultHandle);
        }

        blobMetadataResultHandle = handle;
    }

};

HRESULT hr = XblTitleStorageGetBlobMetadataAsync(
    xboxLiveContext,
    scid,
    storageType,
    blobPath.c_str(),
    xboxUserId,
    skipItems,
    maxItems,
    asyncBlock.get()
);

if (SUCCEEDED(hr))
{
    asyncBlock.release();
}
```

## Existe somente uma página de objetos XblTitleStorageBlobMetadata

O exemplo de código a seguir demonstra como usar `XblTitleStorageBlobMetadataResultHandle` para recuperar a primeira página da lista de objetos [XblTitleStorageBlobMetadata](/pt-BR/reference/live/xsapi-c/title_storage_c/structs/xbltitlestorageblobmetadata).
<Note>Dependendo do número de blobs que o título tem no Title Storage, pode haver várias páginas de `XblTitleStorageBlobMetadata`.</Note>

#### C simples

```cpp theme={null}
XblTitleStorageBlobMetadataResultHandle handle = blobMetadataResultHandle;

const XblTitleStorageBlobMetadata* items;
size_t itemsSize;

HRESULT hr = XblTitleStorageBlobMetadataResultGetItems(handle, &items, &itemsSize);
```

## Determinar se existem mais páginas de objetos XblTitleStorageBlobMetadata

O exemplo de código a seguir demonstra como verificar se há mais páginas de `XblTitleStorageBlobMetadata` a serem recuperadas do Title Storage.

#### C simples

```cpp theme={null}
XblTitleStorageBlobMetadataResultHandle handle = blobMetadataResultHandle;

bool hasNext;

HRESULT hr = XblTitleStorageBlobMetadataResultHasNext(handle, &hasNext);
```

## Recuperar mais páginas de objetos XblTitleStorageBlobMetadata

O exemplo de código a seguir demonstra como recuperar a próxima página de objetos `XblTitleStorageBlobMetadata`.

#### C simples

```cpp theme={null}
XblTitleStorageBlobMetadataResultHandle handle = blobMetadataResultHandle;

auto asyncBlock = std::make_unique<XAsyncBlock>();
asyncBlock->queue = queue;
asyncBlock->context = nullptr;
asyncBlock->callback = [](XAsyncBlock* asyncBlock)
{
    std::unique_ptr<XAsyncBlock> asyncBlockPtr{ asyncBlock };
    XblTitleStorageBlobMetadataResultHandle handle{ nullptr };
    
    HRESULT hr = XblTitleStorageBlobMetadataResultGetNextResult(asyncBlock, &handle);
};

HRESULT hr = XblTitleStorageBlobMetadataResultGetNextAsync(handle, maxItems, asyncBlock.get());

if (SUCCEEDED(hr))
{
    asyncBlock.release();
}
```

## Duplicar XblTitleStorageBlobMetadataResultHandle

O exemplo de código a seguir demonstra como criar uma duplicata de `XblTitleStorageBlobMetadataResultHandle`.

#### C simples

```cpp theme={null}
XblTitleStorageBlobMetadataResultHandle handle = blobMetadataResultHandle;
XblTitleStorageBlobMetadataResultHandle duplicatedHandle;

HRESULT hr = XblTitleStorageBlobMetadataResultDuplicateHandle(handle, &duplicatedHandle);
```

## Fechar XblTitleStorageBlobMetadataResultHandle

O exemplo de código a seguir demonstra como fechar `XblTitleStorageBlobMetadataResultHandle`.

<Note>Você deve fechar esse identificador quando terminar de usá-lo.</Note>

#### C simples

```cpp theme={null}
XblTitleStorageBlobMetadataResultHandle handle = blobMetadataResultHandle;
XblTitleStorageBlobMetadataResultCloseHandle(handle);
blobMetadataResultHandle = nullptr;
```

## Veja também

[XAsyncBlock](/pt-BR/reference/system/xasync/structs/xasyncblock)

[XblTitleStorageBlobMetadataResultCloseHandle](/pt-BR/reference/live/xsapi-c/title_storage_c/functions/xbltitlestorageblobmetadataresultclosehandle)

[XblTitleStorageGetBlobMetadataAsync](/pt-BR/reference/live/xsapi-c/title_storage_c/functions/xbltitlestoragegetblobmetadataasync)

[XblTitleStorageGetBlobMetadataResult](/pt-BR/reference/live/xsapi-c/title_storage_c/functions/xbltitlestoragegetblobmetadataresult)

[XblTitleStorageBlobMetadata](/pt-BR/reference/live/xsapi-c/title_storage_c/structs/xbltitlestorageblobmetadata)

[XblTitleStorageBlobMetadataResultGetItems](/pt-BR/reference/live/xsapi-c/title_storage_c/functions/xbltitlestorageblobmetadataresultgetitems)

[XblTitleStorageBlobMetadataResultHasNext](/pt-BR/reference/live/xsapi-c/title_storage_c/functions/xbltitlestorageblobmetadataresulthasnext)

[XblTitleStorageBlobMetadataResultGetNextAsync](/pt-BR/reference/live/xsapi-c/title_storage_c/functions/xbltitlestorageblobmetadataresultgetnextasync)

[XblTitleStorageBlobMetadataResultGetNextResult](/pt-BR/reference/live/xsapi-c/title_storage_c/functions/xbltitlestorageblobmetadataresultgetnextresult)

[XblTitleStorageBlobMetadataResultDuplicateHandle](/pt-BR/reference/live/xsapi-c/title_storage_c/functions/xbltitlestorageblobmetadataresultduplicatehandle)


## Related topics

- [Código de exemplo do Title Storage](/pt-BR/services/xbox-services/storage/title-storage/how-to/live-title-storage-howto-nav.md)
- [Instruções](/pt-BR/services/xbox-services/storage/title-storage/how-to/index.md)
- [Baixar um blob do Title Storage](/pt-BR/services/xbox-services/storage/title-storage/how-to/live-downloading-title-storage-blob.md)
- [Excluir um blob do Title Storage](/pt-BR/services/xbox-services/storage/title-storage/how-to/live-deleting-title-storage-blob.md)
- [Carregar um blob no Title Storage](/pt-BR/services/xbox-services/storage/title-storage/how-to/live-uploading-title-storage-blob.md)