Metodo IOpcDigitalSignature::GetNamespaces (msopc.h)

Articolo
08/25/2023

Ottiene il prefisso e il mapping dello spazio dei nomi dell'elemento Signature del markup della firma .

Sintassi

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

Parametri

[out] prefixes

Puntatore a un buffer di stringhe di prefisso XML. Se il metodo ha esito positivo, chiamare la funzione CoTaskMemFree per liberare la memoria di ogni stringa nel buffer e quindi liberare la memoria del buffer stesso.

[out] namespaces

Puntatore a un buffer di stringhe dello spazio dei nomi XML. Se il metodo ha esito positivo, chiamare la funzione CoTaskMemFree per liberare la memoria di ogni stringa nel buffer e quindi liberare la memoria del buffer stesso.

[out] count

Dimensioni dei buffer prefissi e spazi dei nomi .

Valore restituito

Il metodo restituisce un HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.

Codice restituito	Descrizione
S_OK	Il metodo è riuscito.
E_POINTER	Il parametro prefissi è NULL.
E_POINTER	Il parametro spazi dei nomi è NULL.
E_POINTER	Il parametro count è NULL.

Commenti

I prefissi e i buffer degli spazi dei nomi vengono mappati l'uno all'altro per indice.

Questo metodo alloca la memoria usata dai buffer restituiti nei prefissi e negli spazi dei nomi e nelle stringhe contenute in ogni buffer.

Esempio

Il codice seguente illustra come usare CoTaskMemFree per liberare la memoria dei buffer e le stringhe che contengono.

// 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);
}

Requisiti


Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	msopc.h