Compartir a través de

Función CertSelectionGetSerializedBlob (cryptuiapi.h)

  • Artículo

La función CertSelectionGetSerializedBlob es una función auxiliar que se usa para recuperar un blob de certificado serializado de una estructura de CERT_SELECTUI_INPUT .

Sintaxis

HRESULT CertSelectionGetSerializedBlob(
  [in]  PCERT_SELECTUI_INPUT pcsi,
  [out] void                 **ppOutBuffer,
  [out] ULONG                *pulOutBufferSize
);

Parámetros

[in] pcsi

Puntero a una estructura de CERT_SELECTUI_INPUT que contiene el almacén de certificados y la información de la cadena de contexto del certificado.

[out] ppOutBuffer

Dirección de un puntero a un búfer que recibe los certificados serializados BLOB.

[out] pulOutBufferSize

Puntero a un ULONG para recibir el tamaño, en bytes, del BLOB recibido en el búfer al que apunta el parámetro ppOutBuffer .

Valor devuelto

Si la función se realiza correctamente, la función devuelve S_OK.

Si se produce un error en la función, devuelve un valor HRESULT que indica el error. Si los parámetros hStore y prgpChain no son NULL, devuelva E_INVALIDARG. Para obtener una lista de códigos de error comunes, consulte Valores HRESULT comunes.

Comentarios

El BLOB serializado devuelto se pasa a la función CredUIPromptForWindowsCredentials en el parámetro pvInAuthBuffer para permitir que un usuario seleccione un certificado mediante la interfaz de usuario de selección de credenciales.

Los certificados que se serializan en el BLOB devuelto en el búfer al que apunta el parámetro ppOutBuffer de esta función dependen de los valores de los miembros hStore y prgpChain de la estructura CERT_SELECTUI_INPUT .

hStore prgpChain Certificados serializados
NULL no NULL Los certificados a los que apunta el miembro prgpChain se serializan.
no NULL NULL Los certificados especificados por el miembro hStore se serializan.
NULL NULL Se devuelve un BLOB vacío.
no NULL no NULL Se produce un error en la llamada y la función devuelve E_INVALIDARG.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado cryptuiapi.h
Archivo DLL Cryptui.dll