nf-mssip-cryptsipretrievesubjectguidforcatalogfile.md

UID	title	description	helpviewer_keywords	old-location	tech.root	ms.assetid	ms.date	ms.keywords	req.header	req.include-header	req.target-type	req.target-min-winverclnt	req.target-min-winversvr	req.kmdf-ver	req.umdf-ver	req.ddi-compliance	req.unicode-ansi	req.idl	req.max-support	req.namespace	req.assembly	req.type-library	req.lib	req.dll	req.irql	targetos	req.typenames	req.redist	ms.custom	f1_keywords	dev_langs	topic_type	api_type	api_location	api_name
NF:mssip.CryptSIPRetrieveSubjectGuidForCatalogFile	CryptSIPRetrieveSubjectGuidForCatalogFile function (mssip.h)	Retrieves the subject GUID associated with the specified file.	CryptSIPRetrieveSubjectGuidForCatalogFile CryptSIPRetrieveSubjectGuidForCatalogFile function [Security] mssip/CryptSIPRetrieveSubjectGuidForCatalogFile security.cryptsipretrievesubjectguidforcatalogfile	security\cryptsipretrievesubjectguidforcatalogfile.htm	security	7f757dc8-948c-476e-aca3-a9051e962ed4	12/05/2018	CryptSIPRetrieveSubjectGuidForCatalogFile, CryptSIPRetrieveSubjectGuidForCatalogFile function [Security], mssip/CryptSIPRetrieveSubjectGuidForCatalogFile, security.cryptsipretrievesubjectguidforcatalogfile	mssip.h		Windows	Windows XP [desktop apps only]	Windows Server 2003 [desktop apps only]										Crypt32.lib	Crypt32.dll		Windows			19H1	CryptSIPRetrieveSubjectGuidForCatalogFile mssip/CryptSIPRetrieveSubjectGuidForCatalogFile	c++	APIRef kbSyntax	DllExport	Crypt32.dll	CryptSIPRetrieveSubjectGuidForCatalogFile

CryptSIPRetrieveSubjectGuidForCatalogFile function

-description

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

-parameters

-param FileName [in]

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

-param hFileIn [in, optional]

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

-param pgSubject [out]

A globally unique ID that identifies the subject.

-returns

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 code	Description
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.