WdfStringGetUnicodeString, fonction (wdfstring.h)

[S’applique à KMDF et UMDF]

La méthode WdfStringGetUnicodeString récupère la chaîne Unicode affectée à un objet de chaîne d’infrastructure spécifié.

Syntaxe

VOID WdfStringGetUnicodeString(
  [in]  WDFSTRING       String,
  [out] PUNICODE_STRING UnicodeString
);

Paramètres

[in] String

Handle vers un objet de chaîne d’infrastructure.

[out] UnicodeString

Pointeur vers une structure UNICODE_STRING qui reçoit un pointeur vers la chaîne Unicode actuellement affectée à l’objet chaîne qui string spécifie.

Valeur de retour

Aucun

Remarques

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

Après WdfStringGetUnicodeString, la structure UNICODE_STRING qui UnicodeString pointe pour contenir un pointeur vers la chaîne Unicode de l’objet de chaîne spécifié, ainsi que la longueur de la chaîne. La chaîne Unicode est allouée dans le pool paginé.

L’infrastructure n’effectue pas de copie de la chaîne pour le pilote.

Pour plus d’informations sur les objets de chaîne de framework, consultez Using String Objects.

Exemples

L’exemple de code suivant obtient la chaîne Unicode affectée à un objet de chaîne d’infrastructure spécifié.

UNICODE_STRING StringName;

WdfStringGetUnicodeString(
                          stringHandle,
                          &StringName
                          );

Exigences

Voir aussi

UNICODE_STRING

WdfStringCreate