WdfRegistryAssignUnicodeString, fonction (wdfregistry.h)

[S’applique à KMDF et UMDF]

La méthode WdfRegistryAssignUnicodeString affecte une chaîne Unicode spécifiée à un nom de valeur spécifié dans le Registre.

Syntaxe

NTSTATUS WdfRegistryAssignUnicodeString(
  [in] WDFKEY           Key,
  [in] PCUNICODE_STRING ValueName,
  [in] PCUNICODE_STRING 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

Pointeur vers une structure UNICODE_STRING qui contient la chaîne à affecter au nom de la valeur qui ValueName spécifie.

Valeur de retour

WdfRegistryAssignUnicodeString 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 la chaîne spécifiée par le paramètre Value n’est pas terminée par NULL, l’infrastructure ajoute un caractère NULL lors de la copie de la chaîne dans le Registre.

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

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

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 une chaîne Unicode « String1 » à la valeur ValueName, sous une clé de Registre spécifiée.

UNICODE_STRING ustring1, valueName;
NTSTATUS status;

RtlInitUnicodeString(
                     &ustring1,
                     L"String1"
                     );
RtlInitUnicodeString(
                     &valueName,
                     L"ValueName"
                     );

status = WdfRegistryAssignUnicodeString(
                                        Key,
                                        &valueName,
                                        &string1
                                        );

Spécifications

Voir aussi

RtlInitUnicodeString

UNICODE_STRING

WdfRegistryAssignMemory

WdfRegistryAssignMultiString

WdfRegistryAssignString

WdfRegistryAssignULong

WdfRegistryAssignValue