共用方式為


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設定適當的錯誤碼。

錯誤碼 意義
WSA_NOT_ENOUGH_MEMORY
記憶體不足,無法執行這項作業。
WSAEACCES
呼叫常式沒有足夠的許可權可存取訊號。
WSAEFAULT
lpServiceClass參數指向的緩衝區太小,無法包含WSASERVICECLASSINFOW結構。 應用程式必須傳入較大的緩衝區。
WSAEINVAL
指定的服務類別識別碼或命名空間提供者識別碼無效。 如果 lpProviderIdlpServiceClassIdlpdwBufSizelpServiceClassInfo 參數是 **Null**,就會傳回此錯誤。
WSAEOPNOTSUPP
不支援此作業。 如果命名空間提供者未實作此函式,就會傳回此錯誤。
WSANO_DATA
要求的名稱有效,但找不到所要求類型的資料。
WSATYPE_NOT_FOUND
找不到指定的類別。

備註

W2_32.dll 使用此函式來實作 WSAGetServiceClassNameByClassId 函式,以及擷取傳遞至 NSPLookupServiceBeginNSPSetService 函式的命名空間特定資訊。

規格需求

   
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 ws2spi.h

另請參閱

NSPInstallServiceClass

NSPLookupServiceBegin

NSPRemoveServiceClass

NSPSetService

WSAGetServiceClassInfo

WSAGetServiceClassNameByClassId

WSASERVICECLASSINFOW

WSASetLastError