WdfRegistryAssignULong, fonction (wdfregistry.h)

[S’applique à KMDF et UMDF]

La méthode WdfRegistryAssignULong attribue une valeur de mot long non signée spécifiée à un nom de valeur spécifié dans le Registre.

Syntaxe

NTSTATUS WdfRegistryAssignULong(
  [in] WDFKEY           Key,
  [in] PCUNICODE_STRING ValueName,
  [in] ULONG            Value
);

Paramètres

[in] Key

Handle vers un objet de clé de Registre qui représente une clé de Registre ouverte.

[in] ValueName

Pointeur vers une structure UNICODE_STRING qui contient un nom de valeur.

[in] Value

Valeur ULONG qui sera affectée au nom de valeur spécifié par ValueName.

Valeur de retour

WdfRegistryAssignULong retourne STATUS_SUCCESS si l’opération réussit. Sinon, la méthode peut retourner l’une des valeurs suivantes :

Cette méthode peut également retourner d’autres valeurs NTSTATUS .

Une vérification de bogue se produit si le pilote fournit un handle d’objet non valide.

Remarques

Si le nom de valeur spécifié par le paramètre ValueName existe déjà, WdfRegistryAssignULong met à jour les données de la valeur.

L’infrastructure définit le type de données de la valeur sur REG_DWORD.

Pour plus d’informations sur les objets de clé de Registre, consultez Utilisation du Registre dans Framework-Based Drivers.

Exemples

L’exemple de code suivant affecte la constante MY_VALUE à la valeur ValueName, sous une clé de Registre spécifiée.

UNICODE_STRING valueName;
NTSTATUS status;

RtlInitUnicodeString(
                     &valueName,
                     L"ValueName"
                     );
status = WdfRegistryAssignULong(
                                Key,
                                &valueName,
                                MY_VALUE
                                );

Spécifications

Voir aussi

UNICODE_STRING

WdfRegistryAssignMemory

WdfRegistryAssignMultiString

WdfRegistryAssignString

WdfRegistryAssignUnicodeString

WdfRegistryAssignValue