Windows Dev Center

Expand Minimize
EN
Este conteúdo não está disponível no seu idioma mas aqui tem a versão em inglês.

CryptSIPRetrieveSubjectGuidForCatalogFile function

The CryptSIPRetrieveSubjectGuidForCatalogFile function retrieves the subject GUID associated with the specified file.

Syntax


BOOL WINAPI CryptSIPRetrieveSubjectGuidForCatalogFile(
  _In_     LPCWSTR FileName,
  _In_opt_ HANDLE  hFileIn,
  _Out_    GUID    *pgSubject
);

Parameters

FileName [in]

The name of the file. If the hFileIn parameter is set, the value in this parameter is ignored.

hFileIn [in, optional]

A handle to the file to check. This parameter must contain a valid handle if the FileName parameter is NULL.

pgSubject [out]

A globally unique ID that identifies the subject.

Return value

The return value is TRUE if the function succeeds; otherwise, FALSE.

If this function returns FALSE, additional error information can be obtained by calling the GetLastError function. GetLastError will return one of the following error codes.

Return codeDescription
ERROR_INVALID_PARAMETER

One or more of the parameters are not valid.

 

Remarks

This function only supports subject interface packages (SIPs) that are used for portable executable images (.exe), cabinet (.cab) images, and flat files.

Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Mssip.h

Library

Crypt32.lib

DLL

Crypt32.dll

 

 

Conteúdo da Comunidade

Adicionar
Mostrar:
© 2015 Microsoft