DdeInitializeA 함수(ddeml.h)

DDEML( 동적 데이터 교환 관리 라이브러리 )에 애플리케이션을 등록합니다. 애플리케이션은 다른 DDEML(동적 데이터 교환 관리 라이브러리) 함수를 호출하기 전에 이 함수를 호출해야 합니다.

구문

UINT DdeInitializeA(
  [in, out] LPDWORD     pidInst,
  [in]      PFNCALLBACK pfnCallback,
  [in]      DWORD       afCmd,
            DWORD       ulRes
);

매개 변수

[in, out] pidInst

형식: LPDWORD

애플리케이션 instance 식별자입니다. 초기화 시 이 매개 변수는 0을 가리킵니다. 함수가 성공하면 이 매개 변수는 애플리케이션의 instance 식별자를 가리킵니다. 이 값은 필요한 다른 모든 DDEML 함수에서 idInst 매개 변수로 전달되어야 합니다. 애플리케이션이 DDEML DLL(동적 연결 라이브러리)의 여러 인스턴스를 사용하는 경우 애플리케이션은 각 instance 대해 다른 콜백 함수를 제공해야 합니다.

pidInst가 0이 아닌 값을 가리키는 경우 DDEML의 다시 초기화가 암시됩니다. 이 경우 pidInst는 유효한 애플리케이션 instance 식별자를 가리킵니다.

[in] pfnCallback

형식: PFNCALLBACK

애플리케이션 정의 DDE 콜백 함수에 대한 포인터입니다. 이 함수는 시스템에서 보낸 DDE 트랜잭션을 처리합니다. 자세한 내용은 DdeCallback 콜백 함수를 참조하세요.

[in] afCmd

형식:DWORD

APPCMD_, CBF_ 및 MF_ 플래그 집합입니다. APPCMD_ 플래그는 DdeInitialize에 대한 특별한 지침을 제공합니다. CBF_ 플래그는 특정 유형의 트랜잭션이 콜백 함수에 도달하지 못하도록 하는 필터를 지정합니다. MF_ 플래그는 DDE 모니터링 애플리케이션이 모니터링하는 DDE 작업의 유형을 지정합니다. 이러한 플래그를 사용하면 콜백 함수에 대한 불필요한 호출을 제거하여 DDE 애플리케이션의 성능을 향상시킵니다.

이 매개 변수는 다음 값 중 하나 이상일 수 있습니다.

ulRes

형식:DWORD

예약; 를 0으로 설정해야 합니다.

반환 값

형식: UINT

함수가 성공하면 반환 값이 DMLERR_NO_ERROR.

함수가 실패하면 반환 값은 다음 값 중 하나입니다.

설명

DDEML의 여러 인스턴스를 사용하는 애플리케이션은 인스턴스 간에 DDEML 개체를 전달해서는 안 됩니다.

DDE 모니터링 애플리케이션은 동일한 애플리케이션 instance 컨텍스트 내에서 DDE 작업(대화 설정, 트랜잭션 발급 등)을 시도해서는 안 됩니다.

동일한 태스크의 instance 이미 진행 중인 동기 트랜잭션이 있는 경우 동기 트랜잭션이 DMLERR_REENTRANCY 오류와 함께 실패합니다.

CBF_FAIL_ALLSVRXACTIONS 플래그를 사용하면 DDEML이 모든 서버 트랜잭션을 필터링하고 DdeInitialize에 대한 후속 호출을 통해 변경할 수 있습니다. APPCMD_CLIENTONLY 플래그는 DDEML이 서버에 대한 키 리소스를 만들지 못하게 하며 DdeInitialize에 대한 후속 호출로 변경할 수 없습니다.

ANSI 버전과 DdeInitialize의 유니코드 버전이 있습니다. 라는 버전은 DDE 대화(ANSI 또는 유니코드)를 제어하는 데 사용되는 창 프로시저의 유형과 CONVCONTEXT 구조체(CP_WINANSI 또는 CP_WINUNICODE)의 iCodePage 멤버에 대한 기본값을 결정합니다.

요구 사항

추가 정보

동적 데이터 교환 관리 라이브러리 개요