共用方式為

LPNSPINSTALLSERVICECLASS 回呼函式 (ws2spi.h)

  • 發行項

NSPInstallServiceClass 函式會在命名空間提供者內註冊服務類別架構。

架構包含類別名稱、類別識別碼，以及服務所有實例通用的任何命名空間特定型別資訊，例如 SAP 識別符或物件識別碼。 動態命名空間提供者預期會儲存與該命名空間相關聯的任何類別資訊。

語法

LPNSPINSTALLSERVICECLASS Lpnspinstallserviceclass;

INT Lpnspinstallserviceclass(
  [in] LPGUID lpProviderId,
  [in] LPWSASERVICECLASSINFOW lpServiceClassInfo
)
{...}

參數

[in] lpProviderId

登錄此服務類別架構之特定命名空間提供者之 GUID 的指標。

[in] lpServiceClassInfo

服務類別架構資訊的指標。

傳回值

如果例程成功，函式應該會 傳回NO_ERROR (零) 。 如果例程失敗，它應該會 傳回 SOCKET_ERROR (–1) ，而且必須使用 WSASetLastError 設定適當的錯誤碼。

錯誤碼 意義
WSA_INVALID_PARAMETER
 命名空間提供者無法提供要求的類別資訊。
WSA_NOT_ENOUGH_MEMORY
 記憶體不足，無法執行這項作業。
WSAEACCES
 呼叫例程沒有足夠的許可權可執行這項作業。
WSAEALREADY
 服務類別資訊已經為此服務類別標識元註冊。 若要修改服務類別資訊，請先呼叫 NSPRemoveServiceClass，然後重新安裝更新的類別信息數據。
WSAEINVAL
 服務類別標識碼無效或結構不正確。 如果 lpServiceClassInfo 參數為 **NULL**，則會傳回此錯誤。
WSAEOPNOTSUPP
 不支援此作業。 如果命名空間提供者未實作此函式，就會傳回此錯誤。
WSANO_DATA
 要求的名稱有效，但找不到所要求類型的數據。

備註

建議使用命名空間提供者，但並非必要，以儲存其所支援之命名空間特有的資訊。

規格需求

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

另請參閱

NSPGetServiceClassInfo

NSPRemoveServiceClass

WSASERVICECLASSINFOW

WSASetLastError