IMofCompiler::CompileBuffer 메서드(wbemcli.h)

아티클
08/27/2023

IMofCompiler::CompileBuffer 메서드는 이진 MOF 데이터가 포함된 버퍼 또는 ASCII 형식의 텍스트 버퍼를 컴파일합니다. 이진 MOF 파일은 구문 분석된 데이터를 포함하며 데이터베이스에 저장되어야 합니다. CompileBuffer 메서드는 NULL로 종료되지 않은 멀티바이트 문자 배열(문자열 버퍼)만 허용합니다.

구문

HRESULT CompileBuffer(
  [in]      long                     BuffSize,
  [in]      BYTE                     *pBuffer,
  [in]      LPWSTR                   ServerAndNamespace,
  [in]      LPWSTR                   User,
  [in]      LPWSTR                   Authority,
  [in]      LPWSTR                   Password,
  [in]      LONG                     lOptionFlags,
  [in]      LONG                     lClassFlags,
  [in]      LONG                     lInstanceFlags,
  [in, out] WBEM_COMPILE_STATUS_INFO *pInfo
);

매개 변수

[in] BuffSize

pBuffer 매개 변수가 가리키는 데이터의 크기입니다.

[in] pBuffer

이진 MOF 파일 데이터 또는 ASCII 형식의 텍스트 버퍼에 대한 포인터입니다.

[in] ServerAndNamespace

서버 및 네임스페이스의 이름입니다.

pBuffer 매개 변수가 텍스트 버퍼를 가리키지 않는 한 이 매개 변수는 무시됩니다. 텍스트 MOF가 #pragma 문 없이 전달되면 MOF 파일이 기본 네임스페이스로 컴파일됩니다. pBuffer가 이진 MOF 파일을 가리키는 경우 ServerAndNamespace 매개 변수는 NULL이어야 합니다.

[in] User

서비스를 요청하는 사용자의 이름입니다.

이 매개 변수는 원격 컴퓨터에서 컴파일하기 위한 자격 증명을 지정합니다. 값이 NULL인 경우 사용자 컨텍스트는 현재 프로세스에서 사용하는 모든 것입니다. 로컬 컴퓨터에 연결할 때 항상 무시됩니다. 자세한 내용은 주의 섹션을 참조하세요.

[in] Authority

원격 컴퓨터에서 컴파일하기 위한 자격 증명을 지정합니다. 값이 NULL이면 현재 프로세스에서 사용 중인 권한 컨텍스트가 무엇이든 됩니다. 이 매개 변수는 로컬 컴퓨터에 연결할 때 항상 무시됩니다. 자세한 내용은 주의 섹션을 참조하세요.

[in] Password

원격 컴퓨터에서 컴파일하기 위한 자격 증명을 지정합니다. 값이 NULL이면 현재 컨텍스트의 암호가 사용됩니다. 이 매개 변수는 로컬 컴퓨터에 연결할 때 항상 무시됩니다.

[in] lOptionFlags

다음 플래그 중 하나 이상을 결합할 수 있습니다.

WBEM_FLAG_CHECK_ONLY

구문 검사 수행합니다.

WBEM_FLAG_AUTORECOVER

메서드가 성공하면 자동 데이터베이스 복구 중에 컴파일할 파일 목록에 파일 이름을 추가합니다.

이 플래그는 네임스페이스, 클래스 또는 instance 플래그와 결합할 수 없습니다.

WBEM_FLAG_CONSOLE_PRINT

콘솔에 다양한 유용한 메시지를 보냅니다.

WBEM_FLAG_DONT_ADD_TO_LIST

자동 데이터베이스 복구 중에 컴파일할 파일 목록에 파일이 추가되지 않도록 합니다.

이 플래그는 WBEM_FLAG_AUTORECOVER 호환되지 않습니다.

[in] lClassFlags

이 매개 변수는 이진 MOF 파일에 이미 정보가 포함되어 있으므로 무시됩니다. 매개 변수 값은 0이어야 합니다.

[in] lInstanceFlags

이진 MOF 파일에 이미 정보가 포함되어 있으므로 무시됩니다. 매개 변수 값은 0이어야 합니다.

[in, out] pInfo

오류를 설명하는 WBEM_COMPILE_STATUS_INFO 대한 포인터입니다.

매개 변수 값이 NULL이 아니면 오류가 발생하고 구조체가 오류 정보로 채워집니다.

반환 값

이 메서드는 성공하면 WBEM_S_NO_ERROR 반환합니다. 메서드가 실패하면 WBEM_S_FALSE 반환합니다.

설명

User 매개 변수가 domain\user> 형식 < 을 사용한다면 Authority 매개 변수는 NULL이어야 합니다.

이진 MOF 데이터는 CompileBuffer 메서드를 호출하기 전에 읽을 수 있는 파일에 이진 MOF 데이터를 저장하는 CreateBMOF 메서드에 의해 생성될 수 있습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista
지원되는 최소 서버	Windows Server 2008
대상 플랫폼	Windows
헤더	wbemcli.h(Wbemidl.h 포함)
라이브러리	Wbemuuid.lib
DLL	Mofd.dll

추가 정보

IMofCompiler

WBEM_COMPILER_OPTIONS

다음을 통해 공유