Fonction CryptSIPRetrieveSubjectGuidForCatalogFile (mssip.h)

  • Article

La fonction CryptSIPRetrieveSubjectGuidForCatalogFile récupère le GUID d’objet associé au fichier spécifié.

Syntaxe

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

Paramètres

[in] FileName

Nom du fichier. Si le paramètre hFileIn est défini, la valeur de ce paramètre est ignorée.

[in, optional] hFileIn

Handle du fichier à case activée. Ce paramètre doit contenir un handle valide si le paramètre FileName a la valeur NULL.

[out] pgSubject

ID global unique qui identifie l’objet.

Valeur retournée

La valeur de retour est TRUE si la fonction réussit ; sinon, FALSE.

Si cette fonction retourne FALSE, des informations d’erreur supplémentaires peuvent être obtenues en appelant la fonction GetLastError . GetLastError retourne l’un des codes d’erreur suivants.

Code de retour Description
ERROR_INVALID_PARAMETER
 Un ou plusieurs paramètres ne sont pas valides.

Remarques

Cette fonction prend uniquement en charge les packages d’interface d’objet (SIP) utilisés pour les images exécutables portables (.exe), les images d’armoire (.cab) et les fichiers plats.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête mssip.h
Bibliothèque Crypt32.lib
DLL Crypt32.dll