DsGetRdnW-Funktion (dsparse.h)

  • Artikel

Die DsGetRdnW-Funktion ruft den Schlüssel und den Wert des ersten relativen Distinguished-Namens und einen Zeiger auf den nächsten relativen distinguished Name aus einer distinguished name-Zeichenfolge ab.

Syntax

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

Parameter

[in, out] ppDN

Adresse eines Unicode-Zeichenfolgenzeigers, der bei einem Eintrag die zu analysierende Distinguished Name-Zeichenfolge enthält. Die Länge dieser Zeichenfolge wird im pcDN-Parameter angegeben. Wenn die Funktion erfolgreich ist, wird dieser Parameter so angepasst, dass er auf den Rest des distinguished Name ohne den aktuellen relativen Distinguished-Namen verweist. Wenn dieser Parameter beispielsweise auf die Zeichenfolge "dc=corp,dc=fabrikam,dc=com" zeigt, zeigt dieser Parameter nach Abschluss der Funktion auf die Zeichenfolge ",dc=fabrikam,dc=com".

[in, out] pcDN

Zeiger auf einen DWORD-Wert , der beim Eintrag die Anzahl der Zeichen in der ppDN-Zeichenfolge enthält. Wenn die Funktion erfolgreich ist, empfängt dieser Parameter die Anzahl der Zeichen im rest des distinguished namens. Diese Werte enthalten kein NULL-endendes Zeichen.

[out] ppKey

Zeiger auf einen LPCWCH-Wert , der, wenn die Funktion erfolgreich ist, einen Zeiger auf den Schlüssel in der relativen Distinguished Name-Zeichenfolge empfängt. Dieser Zeiger befindet sich innerhalb der ppDN-Zeichenfolge und ist nicht null-beendet. Der parameter pcKey empfängt die Anzahl der Zeichen im Schlüssel. Dieser Parameter ist nicht definiert, wenn pcKey null empfängt.

[out] pcKey

Zeiger auf einen DWORD-Wert , der, wenn die Funktion erfolgreich ist, die Anzahl der Zeichen in der Schlüsselzeichenfolge empfängt, die durch den ppKey-Parameter dargestellt wird. Wenn dieser Parameter null empfängt, ist ppKey nicht definiert.

[out] ppVal

Zeiger auf einen LPCWCH-Wert , der, wenn die Funktion erfolgreich ist, einen Zeiger auf den Wert in der relativen Distinguished Name-Zeichenfolge empfängt. Dieser Zeiger befindet sich innerhalb der ppDN-Zeichenfolge und ist nicht null-beendet. Der parameter pcVal empfängt die Anzahl der Zeichen im Wert. Dieser Parameter ist nicht definiert, wenn pcVal null empfängt.

[out] pcVal

Zeiger auf einen DWORD-Wert , der, wenn die Funktion erfolgreich ist, die Anzahl der Zeichen in der Wertzeichenfolge empfängt, die durch den ppVal-Parameter dargestellt wird. Wenn dieser Parameter null empfängt, ist ppVal undefiniert.

Rückgabewert

Gibt ERROR_SUCCESS zurück, wenn erfolgreich oder andernfalls ein Win32-Fehlercode. Mögliche Fehlercodes umfassen die folgenden Werte.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista
Unterstützte Mindestversion (Server) Windows Server 2008
Zielplattform Windows
Kopfzeile dsparse.h (ntdsapi.h einschließen)
Bibliothek Ntdsapi.lib
DLL Ntdsapi.dll

Weitere Informationen

Domänencontroller- und Replikationsverwaltungsfunktionen