IOpcDigitalSignature：：GetNamespaces 方法 (msopc.h)

發行項
08/25/2023

取得簽章標記之 Signature 專案的前置詞和命名空間對應。

語法

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

參數

[out] prefixes

XML 前置詞字串緩衝區的指標。如果方法成功，請呼叫 CoTaskMemFree 函式以釋放緩衝區中每個字串的記憶體，然後釋放緩衝區本身的記憶體。

[out] namespaces

XML 命名空間字串緩衝區的指標。如果方法成功，請呼叫 CoTaskMemFree 函式以釋放緩衝區中每個字串的記憶體，然後釋放緩衝區本身的記憶體。

[out] count

前置詞和命名空間緩衝區的大小。

傳回值

方法會傳回 HRESULT。可能的值包括 (但不限於) 下表中的這些值。

傳回碼	描述
S_OK	此方法已成功。
E_POINTER	前置詞參數為Null。
E_POINTER	命名空間參數為Null。
E_POINTER	count參數為Null。

備註

前置詞和 命名空間 緩衝區會依索引彼此對應。

這個方法會配置在 前置詞 和 命名空間 中傳回的緩衝區所使用的記憶體，以及每個緩衝區中包含的字串。

範例

下列程式碼示範如何使用 CoTaskMemFree 釋放緩衝區的記憶體及其所包含的字串。

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

需求


最低支援的用戶端	Windows 7 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 R2 [僅限傳統型應用程式]
目標平台	Windows
標頭	msopc.h