IOpcDigitalSignature::GetNamespaces-Methode (msopc.h)

Artikel
08/25/2023

Ruft die Präfix- und Namespacezuordnung des Signature-Elements des Signaturmarkups ab.

Syntax

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

Parameter

[out] prefixes

Ein Zeiger auf einen Puffer von XML-Präfixzeichenfolgen. Wenn die Methode erfolgreich ist, rufen Sie die CoTaskMemFree-Funktion auf, um den Arbeitsspeicher der einzelnen Zeichenfolgen im Puffer freizugeben und dann den Arbeitsspeicher des Puffers selbst freizugeben.

[out] namespaces

Ein Zeiger auf einen Puffer von XML-Namespacezeichenfolgen. Wenn die Methode erfolgreich ist, rufen Sie die CoTaskMemFree-Funktion auf, um den Arbeitsspeicher der einzelnen Zeichenfolgen im Puffer freizugeben und dann den Arbeitsspeicher des Puffers selbst freizugeben.

[out] count

Die Größe der Präfixe und Namespacepuffer .

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich ausgeführt.
E_POINTER	Der parameter prefixes ist NULL.
E_POINTER	Der namespaces-Parameter ist NULL.
E_POINTER	Der count-Parameter ist NULL.

Hinweise

Die Präfixe und Namespacepuffer werden nach Index einander zugeordnet.

Diese Methode ordnet Arbeitsspeicher zu, der von den Puffern verwendet wird, die in Präfixen und Namespaces zurückgegeben werden, sowie die Zeichenfolgen, die in jedem Puffer enthalten sind.

Beispiele

Der folgende Code zeigt, wie Sie CoTaskMemFree verwenden, um den Arbeitsspeicher der Puffer und der darin enthaltenen Zeichenfolgen freizugeben.

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

Anforderungen


Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	msopc.h