IUPnPRemoteEndpointInfo::GetDwordValue-Methode (upnphost.h)
Die GetDwordValue-Methode ruft einen 4-Byte-Wert ab, der Informationen zu einer Anforderung oder einem Anforderer bereitstellt.
Syntax
HRESULT GetDwordValue(
[in] BSTR bstrValueName,
[out] DWORD *pdwValue
);
Parameter
[in] bstrValueName
Zeichenfolge, die die Kategorie der abzurufenden Informationen angibt.
[out] pdwValue
Zeiger auf einen 4-Byte-Wert, dessen Bedeutung vom Wert von bstrValueName abhängt.
Wenn bstrValueName "AddressFamily" ist, gibt der 4-Byte-Wert das Format der IP-Adresse des Anforderers wie folgt an. Die Werte werden in Winsock2.h definiert.
| Wert | Bedeutung |
|---|---|
|
IP (IP-Version 4) |
|
IP6 (IP-Version 6) |
Rückgabewert
Wenn die Methode erfolgreich ist, wird der Rückgabewert S_OK. Andernfalls gibt die Methode einen der com-Fehlercodes zurück, die in WinError.h definiert sind.
Hinweise
Derzeit ist der einzige gültige Wert für den bstrValueName-Parameter "AddressFamily". Für jeden anderen Wert gibt diese Methode den COM-Fehlercode E_INVALIDARG zurück.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista, Windows XP mit SP2 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Nicht unterstützt |
| Zielplattform | Windows |
| Kopfzeile | upnphost.h |
| DLL | Upnphost.dll |