Поделиться через


Метод 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. Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице.

Код возврата Описание
S_OK
Метод выполнен успешно.
E_POINTER
Параметр префиксов имеет значение NULL.
E_POINTER
Параметр namespaces имеет значение 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
Header msopc.h

См. также раздел

Основные интерфейсы упаковки

Общие сведения о цифровых подписях

начало работы с помощью API упаковки

IOpcDigitalSignature

Разделы общих сведений

Руководство по программированию API упаковки

Справочник по API упаковки

Примеры API упаковки

Упаковка интерфейсов цифровой подписи

Интерфейсы упаковки

Справочные материалы