Fonction DsGetRdnW (dsparse.h)

La fonction DsGetRdnW récupère la clé et la valeur du premier nom unique relatif et un pointeur vers le nom unique relatif suivant à partir d’une chaîne de nom unique.

Syntaxe

DSPARSE DWORD DsGetRdnW(
  [in, out] LPCWCH *ppDN,
  [in, out] DWORD  *pcDN,
  [out]     LPCWCH *ppKey,
  [out]     DWORD  *pcKey,
  [out]     LPCWCH *ppVal,
  [out]     DWORD  *pcVal
);

Paramètres

[in, out] ppDN

Adresse d’un pointeur de chaîne Unicode qui, lors de l’entrée, contient la chaîne de nom unique à analyser. La longueur de cette chaîne est spécifiée dans le paramètre pcDN . Si la fonction réussit, ce paramètre est ajusté pour pointer vers le reste du nom unique exclusif du nom unique relatif actuel. Par exemple, si ce paramètre pointe vers la chaîne « dc=corp,dc=fabrikam,dc=com », une fois la fonction terminée, ce paramètre pointe vers la chaîne « ,dc=fabrikam,dc=com ».

[in, out] pcDN

Pointeur vers une valeur DWORD qui, lors de l’entrée, contient le nombre de caractères dans la chaîne ppDN . Si la fonction réussit, ce paramètre reçoit le nombre de caractères dans le reste du nom unique. Ces valeurs n’incluent pas le caractère terminé par null.

[out] ppKey

Pointeur vers une valeur LPCWCH qui, si la fonction réussit, reçoit un pointeur vers la clé dans la chaîne de nom unique relative. Ce pointeur se trouve dans la chaîne ppDN et n’est pas terminé par null. Le paramètre pcKey reçoit le nombre de caractères dans la clé. Ce paramètre n’est pas défini si pcKey reçoit zéro.

[out] pcKey

Pointeur vers une valeur DWORD qui, si la fonction réussit, reçoit le nombre de caractères dans la chaîne de clé représentée par le paramètre ppKey . Si ce paramètre reçoit zéro, ppKey n’est pas défini.

[out] ppVal

Pointeur vers une valeur LPCWCH qui, si la fonction réussit, reçoit un pointeur vers la valeur dans la chaîne de nom unique relative. Ce pointeur se trouve dans la chaîne ppDN et n’est pas terminé par null. Le paramètre pcVal reçoit le nombre de caractères dans la valeur. Ce paramètre n’est pas défini si pcVal reçoit zéro.

[out] pcVal

Pointeur vers une valeur DWORD qui, si la fonction réussit, reçoit le nombre de caractères dans la chaîne de valeur représentée par le paramètre ppVal . Si ce paramètre reçoit zéro, ppVal n’est pas défini.

Valeur retournée

Retourne ERROR_SUCCESS en cas de réussite ou un code d’erreur Win32 dans le cas contraire. Les codes d’erreur possibles incluent les valeurs suivantes.

Spécifications

Voir aussi

Fonctions de gestion du contrôleur de domaine et de la réplication