DdeAddData 함수(ddeml.h)

아티클
02/29/2024

지정된 DDE(동적 데이터 교환) 개체에 데이터를 추가합니다. 애플리케이션은 개체의 시작부터 모든 오프셋에서 시작하는 데이터를 추가할 수 있습니다. 새 데이터가 개체에 이미 있는 데이터와 겹치는 경우 새 데이터는 겹치는 경우 이전 데이터를 바이트 단위로 덮어씁니다. 기록되지 않은 개체의 위치 콘텐츠는 정의되지 않습니다.

구문

HDDEDATA DdeAddData(
  [in] HDDEDATA hData,
  [in] LPBYTE   pSrc,
  [in] DWORD    cb,
  [in] DWORD    cbOff
);

매개 변수

[in] hData

형식: HDDEDATA

추가 데이터를 수신하는 DDE 개체에 대한 핸들입니다.

[in] pSrc

형식: LPBYTE

DDE 개체에 추가할 데이터입니다.

[in] cb

형식:DWORD

데이터가 문자열인 경우 종결 NULL을 포함하여 DDE 개체에 추가할 데이터의 길이(바이트)입니다.

[in] cbOff

형식:DWORD

DDE 개체의 시작부터 오프셋(바이트)입니다. 추가 데이터는 이 오프셋부터 개체에 복사됩니다.

반환 값

형식: HDDEDATA

함수가 성공하면 반환 값은 DDE 개체에 대한 새 핸들입니다. 새 핸들은 개체에 대한 모든 참조에서 사용됩니다.

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

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

설명

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

원래 할당된 메모리 양이 추가된 데이터를 보유하는 데 필요한 것보다 적으면 DdeAddData 는 적절한 크기의 전역 메모리 개체를 다시 할당합니다.

요구 사항

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