DsGetRdnW-Funktion (dsparse.h)

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

Weitere Informationen

Domänencontroller- und Replikationsverwaltungsfunktionen