KsUnserializeObjectPropertiesFromRegistry, fonction (ks.h)

La fonction KsUnserializeObjectPropertiesFromRegistry, lorsqu’elle est donnée à un objet de destination et à un chemin de Registre, énumère les valeurs nommées et les applique en tant que données sérialisées aux jeux de propriétés spécifiés répertoriés dans les données sérialisées. Un IRP est généré lors de l’envoi des données sérialisées. Par conséquent, aucune hypothèse n’est faite sur l’utilisation de structures de propriétés KS pour définir en interne les jeux de propriétés. La fonction n’utilise pas les noms des valeurs.

Syntaxe

KSDDKAPI NTSTATUS KsUnserializeObjectPropertiesFromRegistry(
  [in]           PFILE_OBJECT    FileObject,
  [in, optional] HANDLE          ParentKey,
  [in, optional] PUNICODE_STRING RegistryPath
);

Paramètres

[in] FileObject

Spécifie l’objet de fichier dont les propriétés sont définies.

[in, optional] ParentKey

Contient éventuellement un handle au parent du chemin d’accès, ou NULL. La clé parente et/ou le RegistryPath doivent être passés.

[in, optional] RegistryPath

Contient éventuellement le chemin d’accès à la clé dont les sous-clés seront énumérées en tant que jeux de propriétés, ou sinon NULL. La ParentKey et/ou le chemin d’accès au Registre doivent être passés.

Valeur de retour

La fonction KsUnserializeObjectPropertiesFromRegistry retourne STATUS_SUCCESS si les jeux de propriétés n’ont pas été mis en valeur. La fonction retourne une erreur si le chemin d’accès au Registre n’était pas valide, l’une des sous-clés n’était pas valide, la définition d’une propriété a échoué, le format sérialisé n’était pas valide ou un jeu de propriétés n’était pas pris en charge sur l’objet.

Exigences

Exigence	Valeur
plateforme cible	Universel
d’en-tête	ks.h (include Ks.h)
bibliothèque	Ks.lib