Método IOpcDigitalSignature::GetNamespaces (msopc.h)

Artigo
08/25/2023

Obtém o prefixo e o mapeamento de namespace do elemento Signature da marcação de assinatura.

Sintaxe

HRESULT GetNamespaces(
  [out] LPWSTR **prefixes,
  [out] LPWSTR **namespaces,
  [out] UINT32 *count
);

Parâmetros

[out] prefixes

Um ponteiro para um buffer de cadeias de caracteres de prefixo XML. Se o método for bem-sucedido, chame a função CoTaskMemFree para liberar a memória de cada cadeia de caracteres no buffer e liberar a memória do próprio buffer.

[out] namespaces

Um ponteiro para um buffer de cadeias de caracteres de namespace XML. Se o método for bem-sucedido, chame a função CoTaskMemFree para liberar a memória de cada cadeia de caracteres no buffer e liberar a memória do próprio buffer.

[out] count

O tamanho dos buffers de prefixos e namespaces .

Valor retornado

O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.
E_POINTER	O parâmetro prefixos é NULL.
E_POINTER	O parâmetro namespaces é NULL.
E_POINTER	O parâmetro count é NULL.

Comentários

Os buffers de prefixos e namespaces são mapeados entre si por índice.

Esse método aloca memória usada pelos buffers retornados em prefixos e namespaces e as cadeias de caracteres contidas em cada buffer.

Exemplos

O código a seguir mostra como usar CoTaskMemFree para liberar a memória dos buffers e as cadeias de caracteres que eles contêm.

// Prepare to call GetNamespaces
LPWSTR* prefixes = NULL;
LPWSTR* namespaces = NULL;
UINT32 count = 0;

// Call to GetNamespaces succeeds
if ( SUCCEEDED( signature->GetNamespaces(&prefixes, &namespaces, &count) ) )
{
    // Process strings in prefixes and namespaces as needed for the application

    // Free memory for each string
    for (UINT32 i = 0; i < count; i++)
    {
        CoTaskMemFree(prefixes[i]);
        CoTaskMemFree(namespaces[i]);
    }
    // Free memory for the buffers
    CoTaskMemFree(prefixes);
    CoTaskMemFree(namespaces);
}

Requisitos


Cliente mínimo com suporte	Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	msopc.h