Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
The CryptSIPRetrieveSubjectGuidForCatalogFile function retrieves the subject GUID associated with the specified file.
Syntax
BOOL CryptSIPRetrieveSubjectGuidForCatalogFile(
[in] LPCWSTR FileName,
[in, optional] HANDLE hFileIn,
[out] GUID *pgSubject
);
Parameters
[in] FileName
The name of the file. If the hFileIn parameter is set, the value in this parameter is ignored.
[in, optional] hFileIn
A handle to the file to check. This parameter must contain a valid handle if the FileName parameter is NULL.
[out] pgSubject
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 code | Description |
|---|---|
|
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
| Requirement | Value |
|---|---|
| Minimum supported client | Windows XP [desktop apps only] |
| Minimum supported server | Windows Server 2003 [desktop apps only] |
| Target Platform | Windows |
| Header | mssip.h |
| Library | Crypt32.lib |
| DLL | Crypt32.dll |