IUPnPRemoteEndpointInfo：：GetDwordValue 方法 (upnphost.h)
GetDwordValue 方法會取得 4 位元組值，提供要求或要求者的相關信息。
語法
HRESULT GetDwordValue(
[in] BSTR bstrValueName,
[out] DWORD *pdwValue
);
參數
[in] bstrValueName
字串，指定要擷取的信息類別。
[out] pdwValue
4 位元組值的指標，其意義取決於 bstrValueName 的值。
如果 bstrValueName 為 “AddressFamily”，則 4 位元組值會指出要求者 IP 位址的格式，如下所示。 這些值定義於 Winsock2.h 中。
| 值 | 意義 |
|---|---|
|
IP (IP 第 4 版) |
|
IP6 (IP 第 6 版) |
傳回值
如果方法成功，傳回值會S_OK。 否則，方法會傳回 WinError.h 中定義的其中一個 COM 錯誤碼。
備註
目前， bstrValueName 參數的唯一有效值為 “AddressFamily”。 對於任何其他值，這個方法會傳回 COM 錯誤碼E_INVALIDARG。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows Vista、Windows XP SP2 [僅限傳統型應用程式] |
| 最低支援的伺服器 | 都不支援 |
| 目標平台 | Windows |
| 標頭 | upnphost.h |
| Dll | Upnphost.dll |