RoGetServerActivatableClasses 함수(roregistrationapi.h)

호출 프로세스의 패키지 ID 아래에 등록된 지정된 EXE(실행 파일) 서버에 대해 등록된 활성화 가능한 클래스를 검색합니다.

구문

HRESULT RoGetServerActivatableClasses(
  [in]  HSTRING serverName,
  [out] HSTRING **activatableClassIds,
  [out] DWORD   *count
);

매개 변수

[in] serverName

형식: HSTRING

클래스 등록을 검색할 서버의 이름입니다. 이 서버 이름은 서버가 활성화될 때 명령줄에 전달됩니다.

[out] activatableClassIds

형식: HSTRING**

서버가 제공하도록 등록된 활성화 가능한 클래스 ID 문자열의 호출 수신자 할당 배열입니다. WindowsDeleteString 함수를 사용하여 호출자가 문자열을 해제해야 합니다. 그런 다음 CoTaskMemFree를 사용하여 버퍼를 해제해야 합니다. 서버(호출자)는 이러한 클래스에 대한 정품 인증 팩터리를 등록해야 합니다.

[out] count

형식: DWORD*

activatableClassIds 배열에 반환된 활성화 가능한 클래스 ID의 수입니다.

반환 값

형식: HRESULT

메서드는 성공하면 S_OK 반환하고, 그렇지 않으면 다음을 포함한 오류 코드를 반환합니다.

반환 코드 설명
REGDB_E_CLASSNOTREG
빈 서버 이름이 제공되거나, 서버가 등록되지 않았거나, 이 서버에 대해 등록된 클래스가 없습니다.
E_ACCESSDENIED
프로세스에 이 서버의 등록을 읽을 수 있는 충분한 권한이 없습니다.

설명

RoGetServerActivatableClasses 함수를 사용하여 서버가 제공해야 하는 클래스 이름을 검색합니다. 각 클래스 이름에서 RoGetActivatableClassRegistration 함수를 개별적으로 호출하여 개별 클래스에 대한 세부 정보를 가져옵니다.

요구 사항

요구 사항
지원되는 최소 클라이언트 Windows 8 [데스크톱 앱 | UWP 앱]
지원되는 최소 서버 Windows Server 2012 [데스크톱 앱 | UWP 앱]
대상 플랫폼 Windows
헤더 roregistrationapi.h
라이브러리 Runtimeobject.lib