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
| 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 |