Метод IOpcDigitalSignature::GetNamespaces (msopc.h)
Возвращает префикс и сопоставление пространства имен элемента Signature разметки подписи.
Синтаксис
HRESULT GetNamespaces(
[out] LPWSTR **prefixes,
[out] LPWSTR **namespaces,
[out] UINT32 *count
);
Параметры
[out] prefixes
Указатель на буфер строк префикса XML. Если метод завершается успешно, вызовите функцию CoTaskMemFree , чтобы освободить память каждой строки в буфере, а затем освободить память самого буфера.
[out] namespaces
Указатель на буфер строк пространства имен XML. Если метод завершается успешно, вызовите функцию CoTaskMemFree , чтобы освободить память каждой строки в буфере, а затем освободить память самого буфера.
[out] count
Размер буферов префиксов и пространств имен .
Возвращаемое значение
Метод возвращает HRESULT. Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице.
Код возврата | Описание |
---|---|
|
Метод выполнен успешно. |
|
Параметр префиксов имеет значение NULL. |
|
Параметр namespaces имеет значение NULL. |
|
Параметр 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 |
Header | msopc.h |
См. также раздел
Общие сведения о цифровых подписях
начало работы с помощью API упаковки
Разделы общих сведений
Руководство по программированию API упаковки
Упаковка интерфейсов цифровой подписи
Справочные материалы