WSAInstallServiceClassA 함수(winsock2.h)

아티클
08/27/2023

WSAInstallServiceClass 함수는 네임스페이스 내에 서비스 클래스 스키마를 등록합니다. 이 스키마에는 클래스 이름, 클래스 식별자 및 SAP 식별자 또는 개체 식별자와 같은 서비스의 모든 인스턴스에 공통적인 네임스페이스 관련 정보가 포함됩니다.

구문

INT WSAAPI WSAInstallServiceClassA(
  [in] LPWSASERVICECLASSINFOA lpServiceClassInfo
);

매개 변수

[in] lpServiceClassInfo

네임스페이스에 대한 서비스 클래스 특정 형식 매핑 정보입니다. 여러 매핑을 한 번에 처리할 수 있습니다.

관련 데이터 구조에 대한 설명은 서비스 클래스 데이터 구조 섹션을 참조하세요.

반환 값

작업이 성공한 경우 반환 값은 0입니다. 그렇지 않으면 SOCKET_ERROR 값이 반환되고 WSAGetLastError를 호출하여 특정 오류 번호를 검색할 수 있습니다.

오류 코드	의미
WSA_INVALID_PARAMETER	네임스페이스 공급자는 요청된 클래스 정보를 제공할 수 없습니다.
WSA_NOT_ENOUGH_MEMORY	작업을 수행할 메모리가 부족했습니다.
WSAEACCES	호출 함수에 서비스를 설치할 수 있는 충분한 권한이 없습니다.
WSAEALREADY	이 서비스 클래스 식별자에 대한 서비스 클래스 정보가 이미 등록되었습니다. 서비스 클래스 정보를 수정하려면 먼저 WSARemoveServiceClass를 사용한 다음 업데이트된 클래스 정보 데이터로 다시 설치합니다.
WSAEINVAL	서비스 클래스 정보가 잘못되었거나 잘못 구조화되었습니다. lpServiceClassInfo 매개 변수가 NULL인 경우 이 오류가 반환됩니다.
WSAEOPNOTSUPP	이 작업은 지원되지 않습니다. 네임스페이스 공급자가 이 함수를 구현하지 않으면 이 오류가 반환됩니다.
WSANO_DATA	요청한 이름은 유효하지만 요청한 형식의 데이터를 찾을 수 없습니다.
WSANOTINITIALISED	WS2_32.DLL 초기화되지 않았습니다. 애플리케이션은 Windows 소켓 함수를 호출하기 전에 먼저 WSAStartup 을 호출해야 합니다.

설명

참고

winsock2.h 헤더는 WSAInstallServiceClass를 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항


지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	winsock2.h
라이브러리	Ws2_32.lib
DLL	Ws2_32.dll