Función CertSelectionGetSerializedBlob (cryptuiapi.h)

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