LPNSPGETSERVICECLASSINFO 回呼函式 (ws2spi.h)
NSPGetServiceClassInfo函式會擷取與命名空間提供者相關的所有相關類別資訊 (架構) 。 此呼叫會擷取服務所有實例通用的任何命名空間特定資訊,包括 SAP 的連線資訊,或 SAP 或 TCP 的埠資訊。
語法
LPNSPGETSERVICECLASSINFO Lpnspgetserviceclassinfo;
INT Lpnspgetserviceclassinfo(
[in] LPGUID lpProviderId,
[in, out] LPDWORD lpdwBufSize,
[in, out] LPWSASERVICECLASSINFOW lpServiceClassInfo
)
{...}
參數
[in] lpProviderId
要從中擷取服務類別架構之特定命名空間提供者之 GUID 的指標。
[in, out] lpdwBufSize
在輸入時, lpServiceClassInfo 參數所指向緩衝區的大小,以位元組為單位。
在輸出中,如果函式失敗且錯誤為 WSAEFAULT,此參數會指定擷取記錄所需的 lpServiceClassInfo 參數所指向之緩衝區的最小大小,以位元組為單位。
[in, out] lpServiceClassInfo
傳回 WSASERVICECLASSINFOW 結構的指標,其中包含命名空間特定對應資訊的服務類別。 必須填入 lpServiceClassId 參數,以指出應該傳回哪些 WSASERVICECLASSINFOW 記錄。
傳回值
如果沒有發生錯誤, NSPGetServiceClassInfo 函式會傳回 NO_ERROR (零) 。 否則會傳回 SOCKET_ERROR (-1) ,而且命名空間提供者必須使用 WSASetLastError設定適當的錯誤碼。
錯誤碼 | 意義 |
---|---|
記憶體不足,無法執行這項作業。 | |
呼叫常式沒有足夠的許可權可存取訊號。 | |
lpServiceClass參數指向的緩衝區太小,無法包含WSASERVICECLASSINFOW結構。 應用程式必須傳入較大的緩衝區。 | |
指定的服務類別識別碼或命名空間提供者識別碼無效。 如果 lpProviderId、 lpServiceClassId、 lpdwBufSize或 lpServiceClassInfo 參數是 **Null**,就會傳回此錯誤。 | |
不支援此作業。 如果命名空間提供者未實作此函式,就會傳回此錯誤。 | |
要求的名稱有效,但找不到所要求類型的資料。 | |
找不到指定的類別。 |
備註
W2_32.dll 使用此函式來實作 WSAGetServiceClassNameByClassId 函式,以及擷取傳遞至 NSPLookupServiceBegin 和 NSPSetService 函式的命名空間特定資訊。
規格需求
最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | ws2spi.h |