DdeCreateStringHandleA 함수(ddeml.h)

아티클
11/20/2024

지정된 문자열을 식별하는 핸들을 만듭니다. DDE(동적 데이터 교환) 클라이언트 또는 서버 애플리케이션은 문자열 핸들을 다른 DDEML(동적 데이터 교환 관리 라이브러리) 함수에 매개 변수로 전달할 수 있습니다.

통사론

HSZ DdeCreateStringHandleA(
  [in] DWORD  idInst,
  [in] LPCSTR psz,
  [in] int    iCodePage
);

매개 변수

[in] idInst

형식: DWORD

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

[in] psz

형식: LPTSTR

핸들을 만들 null로 끝나는 문자열입니다. 이 문자열은 최대 255자까지 가능합니다. 이 제한의 이유는 DDEML 문자열 관리 함수가 원자를 사용하여 구현되기 때문입니다.

[in] iCodePage

형식: int

문자열을 렌더링하는 데 사용할 코드 페이지입니다. 이 값은 클라이언트 애플리케이션에서 CP_WINANSI(기본 코드 페이지) 또는 CP_WINUNICODE DdeInitialize ANSI 또는 유니코드 버전이 호출되었는지 여부에 따라 달라집니다.

반환 값

형식: HSZ

함수가 성공하면 반환 값은 문자열 핸들입니다.

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

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

발언

문자열 핸들의 값은 식별되는 문자열의 경우와 관련이 없습니다.

애플리케이션이 문자열 핸들을 만들거나 콜백 함수에서 문자열 핸들을 받은 다음 DdeKeepStringHandle 함수를 사용하여 이를 유지하는 경우 애플리케이션은 더 이상 필요하지 않은 경우 해당 문자열 핸들을 해제해야 합니다.

인스턴스별 문자열 핸들은 문자열 핸들에서 문자열로, 다시 문자열 핸들로 매핑할 수 없습니다. 다음 예제에서는 DdeQueryString 함수가 문자열 핸들에서 문자열을 만들고 DdeCreateStringHandle 해당 문자열에서 문자열 핸들을 만들지만 두 핸들은 동일하지 않습니다.

DWORD idInst; 
DWORD cb; 
HSZ hszInst, hszNew; 
PSZ pszInst; 
 
DdeQueryString(idInst, hszInst, pszInst, cb, CP_WINANSI); 
hszNew = DdeCreateStringHandle(idInst, pszInst, CP_WINANSI); 
// hszNew != hszInst !

메모

ddeml.h 헤더는 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 DdeCreateStringHandle을 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입대한 규칙을 참조하세요.

요구 사항

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