DdeCreateDataHandle 함수(ddeml.h)

아티클
08/23/2023

DDE(동적 데이터 교환) 개체를 만들고 지정된 버퍼의 데이터로 개체를 채웁니다. DDE 애플리케이션은 파트너 애플리케이션에 데이터를 전달하는 트랜잭션 중에 이 함수를 사용합니다.

구문

HDDEDATA DdeCreateDataHandle(
  [in]           DWORD  idInst,
  [in, optional] LPBYTE pSrc,
  [in]           DWORD  cb,
  [in]           DWORD  cbOff,
  [in, optional] HSZ    hszItem,
  [in]           UINT   wFmt,
  [in]           UINT   afCmd
);

매개 변수

[in] idInst

형식:DWORD

애플리케이션 instance DdeInitialize 함수에 대한 이전 호출에서 얻은 식별자입니다.

[in, optional] pSrc

형식: LPBYTE

DDE 개체에 복사할 데이터입니다. 이 매개 변수가 NULL이면 개체에 데이터가 복사되지 않습니다.

[in] cb

형식:DWORD

pSrc가 가리키는 버퍼에서 복사할 메모리 양(바이트)입니다. (데이터가 문자열인 경우 종료 NULL 포함). 이 매개 변수가 0이면 pSrc 매개 변수가 무시됩니다.

[in] cbOff

형식:DWORD

pSrc 매개 변수가 가리키는 버퍼의 시작 부분에서 오프셋(바이트)입니다. 이 오프셋에서 시작하는 데이터는 버퍼에서 DDE 개체로 복사됩니다.

[in, optional] hszItem

형식: HSZ

DDE 개체에 해당하는 데이터 항목을 지정하는 문자열에 대한 핸들입니다. 이 핸들은 DdeCreateStringHandle 함수에 대한 이전 호출에 의해 만들어졌어야 합니다. 데이터 핸들을 XTYP_EXECUTE 트랜잭션에 사용할 경우 이 매개 변수는 0L이어야 합니다.

[in] wFmt

형식: UINT

데이터의 표준 클립보드 형식입니다.

[in] afCmd

형식: UINT

생성 플래그입니다. 이 매개 변수는 DdeCreateDataHandle 함수를 호출하는 서버 애플리케이션이 이 함수가 만드는 데이터 핸들을 소유하게 지정하는 HDATA_APPOWNED 수 있습니다. 이 플래그를 사용하면 애플리케이션이 각 애플리케이션에 전달할 별도의 핸들을 만드는 대신 다른 DDEML 애플리케이션과 데이터 핸들을 공유할 수 있습니다. 이 플래그를 지정하면 애플리케이션은 결국 DdeFreeDataHandle 함수를 사용하여 핸들과 연결된 공유 메모리 개체를 해제해야 합니다. 이 플래그를 지정하지 않으면 데이터 핸들이 애플리케이션의 DDE 콜백 함수에서 반환되거나 다른 DDEML 함수에서 매개 변수로 사용된 후 핸들을 만든 애플리케이션에서 핸들이 유효하지 않습니다.

반환 값

형식: HDDEDATA

함수가 성공하면 반환 값은 데이터 핸들입니다.

함수가 실패하면 반환 값은 0L입니다.

DdeGetLastError 함수를 사용하여 다음 값 중 하나일 수 있는 오류 코드를 가져올 수 있습니다.

설명

DDE 개체의 채워지지 않은 위치는 정의되지 않습니다.

데이터 핸들이 다른 DDEML 함수에서 매개 변수로 사용되었거나 DDE 콜백 함수에서 반환된 후 핸들은 핸들로 식별된 DDE 개체에 대한 읽기 액세스에만 사용할 수 있습니다.

요구 사항


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