Compartir a través de

Función CryptSIPRetrieveSubjectGuidForCatalogFile (mssip.h)

  • Artículo

La función CryptSIPRetrieveSubjectGuidForCatalogFile recupera el GUID del firmante asociado al archivo especificado.

Sintaxis

BOOL CryptSIPRetrieveSubjectGuidForCatalogFile(
  [in]           LPCWSTR FileName,
  [in, optional] HANDLE  hFileIn,
  [out]          GUID    *pgSubject
);

Parámetros

[in] FileName

Nombre del archivo. Si se establece el parámetro hFileIn , se omite el valor de este parámetro.

[in, optional] hFileIn

Identificador del archivo que se va a comprobar. Este parámetro debe contener un identificador válido si el parámetro FileName es NULL.

[out] pgSubject

Identificador único global que identifica al sujeto.

Valor devuelto

El valor devuelto es TRUE si la función se realiza correctamente; de lo contrario, FALSE.

Si esta función devuelve FALSE, se puede obtener información de error adicional llamando a la función GetLastError . GetLastError devolverá uno de los siguientes códigos de error.

Código devuelto Descripción
ERROR_INVALID_PARAMETER
 Uno o varios de los parámetros no son válidos.

Comentarios

Esta función solo admite paquetes de interfaz de asunto (SIP) que se usan para imágenes ejecutables portátiles (.exe), imágenes de gabinete (.cab) y archivos planos.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado mssip.h
Library Crypt32.lib
Archivo DLL Crypt32.dll