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
Zeiger auf eine NULL-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-Array .
[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_INET sein. EntryCount enthält die Anzahl der Elemente in diesem Array.
[out] SiteNames
Empfängt ein Array von NULL-beendeten Zeichenfolgenzeigern, die die Websitenamen für die Adressen enthalten. Jedes Element in diesem Array entspricht demselben Element im SocketAddresses-Array . Ein Element ist NULL , wenn die entsprechende Adresse keiner bekannten Website zugeordnet ist oder wenn der Adresseintrag nicht die richtige Form aufweist. Der Aufrufer muss dieses Array freigeben, wenn es nicht mehr benötigt wird, indem Er NetApiBufferFree aufruft.
Rückgabewert
Gibt NO_ERROR zurück, wenn erfolgreich oder andernfalls ein Win32- oder RPC-Fehler auftritt. Die folgende Liste listet mögliche Fehlercodes auf.
Hinweise
Hinweis
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 nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows Vista |
| Unterstützte Mindestversion (Server) | Windows Server 2008 |
| Zielplattform | Windows |
| Kopfzeile | dsgetdc.h |
| Bibliothek | Netapi32.lib |
| DLL | Netapi32.dll |