DsAddressToSiteNamesA-Funktion (dsgetdc.h)
Die DsAddressToSiteNames Funktion ruft die Websitenamen ab, die den angegebenen Adressen entsprechen.
Syntax
DSGETDCAPI DWORD DsAddressToSiteNamesA(
[in, optional] LPCSTR ComputerName,
[in] DWORD EntryCount,
[in] PSOCKET_ADDRESS SocketAddresses,
[out] LPSTR **SiteNames
);
Parameter
[in, optional] ComputerName
Zeigen Sie auf eine mit Null beendete Zeichenfolge, die den Namen des Remoteservers angibt, der diese Funktion verarbeiten soll. Dieser Parameter muss der Name eines Domänencontrollers sein. Ein Nicht-Domänencontroller kann diese Funktion aufrufen, indem DsGetDcName- aufgerufen wird, um den Domänencontroller zu finden.
[in] EntryCount
Enthält die Anzahl der Elemente im SocketAddresses Arrays.
[in] SocketAddresses
Enthält ein Array von SOCKET_ADDRESS Strukturen, die die zu konvertierenden Adressen enthalten. Jede Adresse in diesem Array muss vom Typ AF_INETsein. EntryCount- enthält die Anzahl der Elemente in diesem Array.
[out] SiteNames
Empfängt ein Array mit null-beendeten Zeichenfolgenzeigern, die die Websitenamen für die Adressen enthalten. Jedes Element in diesem Array entspricht demselben Element im SocketAddresses Arrays. Ein Element ist NULL-, wenn die entsprechende Adresse keiner bekannten Website zugeordnet ist oder der Adresseintrag nicht das richtige Formular aufweist. Der Aufrufer muss dieses Array freigeben, wenn es nicht mehr erforderlich ist, indem NetApiBufferFreeaufgerufen wird.
Rückgabewert
Gibt NO_ERROR zurück, wenn ein Win32- oder RPC-Fehler andernfalls erfolgreich war. In der folgenden Liste sind mögliche Fehlercodes aufgeführt.
Bemerkungen
Anmerkung
Der dsgetdc.h-Header definiert DsAddressToSiteNames als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows Vista |
| mindestens unterstützte Server- | Windows Server 2008 |
| Zielplattform- | Fenster |
| Header- | dsgetdc.h |
| Library | Netapi32.lib |
| DLL- | Netapi32.dll |