Função CryptSIPRetrieveSubjectGuidForCatalogFile (mssip.h)

  • Artigo

A função CryptSIPRetrieveSubjectGuidForCatalogFile recupera o GUID do assunto associado ao arquivo especificado.

Sintaxe

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

Parâmetros

[in] FileName

O nome do arquivo. Se o parâmetro hFileIn for definido, o valor nesse parâmetro será ignorado.

[in, optional] hFileIn

Um identificador para o arquivo a ser marcar. Esse parâmetro deverá conter um identificador válido se o parâmetro FileName for NULL.

[out] pgSubject

Uma ID globalmente exclusiva que identifica o assunto.

Retornar valor

O valor retornado será TRUE se a função for bem-sucedida; caso contrário, FALSE.

Se essa função retornar FALSE, informações de erro adicionais poderão ser obtidas chamando a função GetLastError . GetLastError retornará um dos seguintes códigos de erro.

Código de retorno Descrição
ERROR_INVALID_PARAMETER
 Um ou mais dos parâmetros não são válidos.

Comentários

Essa função dá suporte apenas a SIPs ( pacotes de interface de assunto ) que são usados para imagens executáveis portáteis (.exe), imagens de gabinete (.cab) e arquivos simples.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho mssip.h
Biblioteca Crypt32.lib
DLL Crypt32.dll