RpcObjectSetType 함수(rpcdce.h)

RpcObjectSetType 함수는 개체의 형식을 할당합니다.

구문

RPC_STATUS RpcObjectSetType(
  UUID *ObjUuid,
  UUID *TypeUuid
);

매개 변수

ObjUuid

TypeUuid 매개 변수의 UUID 형식과 연결할 개체 UUID에 대한 포인터입니다.

TypeUuid

ObjUuid 매개 변수의 UUID 형식에 대한 포인터입니다.

NULL 또는 nil UUID의 매개 변수 값을 지정하여 개체 형식을 개체 UUID/nil 형식 UUID의 기본 연결로 다시 설정합니다.

반환 값

값	의미
RPC_S_OK	호출이 성공했습니다.
RPC_S_INVALID_OBJECT	개체가 잘못되었습니다.
RPC_S_ALREADY_REGISTERED	개체가 이미 등록되어 있습니다.
RPC_S_OUT_OF_MEMORY	시스템이 메모리가 부족합니다.

 

참고 유효한 오류 코드 목록은 RPC 반환 값을 참조하세요.

 

설명

서버 애플리케이션은 RpcObjectSetType 을 호출하여 UUID 형식을 개체 UUID에 할당합니다. 기본적으로 RPC 런타임 라이브러리는 nil 형식 UUID를 사용하여 모든 개체 UUID를 자동으로 할당합니다. 서버가 nil 형식 UUID를 사용하여 인터페이스를 등록한 경우 인터페이스의 구현(하나의 관리자 진입점 벡터 [EPV])을 포함하는 서버 애플리케이션은 RpcObjectSetType 을 호출할 필요가 없습니다( RpcServerRegisterIf 아래 참조).

인터페이스의 여러 구현(여러 관리자 EPV, 즉 여러 형식 UUID)이 포함된 서버 애플리케이션은 서버에서 지원하는 각 개체 UUID/비 Nil 형식 UUID 연결에 대해 RpcObjectSetType 을 한 번 호출합니다. 각 개체를 UUID 형식과 연결하면 서버가 Nil이 아닌 개체 UUID에 대한 원격 프로시저 호출을 받을 때 사용할 관리자 EPV(인터페이스 구현)가 RPC 런타임 라이브러리에 지시됩니다.

RPC 런타임 라이브러리를 사용하면 애플리케이션에서 무제한 수의 개체에 대한 형식을 설정할 수 있습니다. 개체 UUID와 해당 형식 UUID( RpcObjectSetType을 호출하여 설정됨) 간의 연결을 제거하기 위해 서버는 RpcObjectSetType 을 다시 호출하여 TypeUuid 매개 변수에 대해 null 값 또는 nil UUID를 지정합니다. 그러면 개체 UUID/형식 UUID 연결이 개체 UUID/nil 형식 UUID의 기본 연결로 다시 설정됩니다. 서버는 nil 개체 UUID에 형식을 할당할 수 없습니다. RPC 런타임 라이브러리는 nil 개체 UUID에 nil 형식 UUID를 자동으로 할당합니다.

자세한 내용은 인터페이스 등록을 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	rpcdce.h(Rpc.h 포함)
라이브러리	Rpcrt4.lib
DLL	Rpcrt4.dll

추가 정보

인터페이스 등록

RpcServerRegisterIf