DdeSetQualityOfService 함수(dde.h)

아티클
08/23/2023

향후 DDE 대화에 필요한 원시 DDE(동적 데이터 교환) 애플리케이션의 QOS(서비스 품질)를 지정합니다. 지정된 QOS는 해당 설정이 있는 동안 시작된 모든 대화에 적용됩니다. DDE 대화의 서비스 품질은 대화 기간 동안 지속됩니다. 대화 중에 DdeSetQualityOfService 함수에 대한 호출은 해당 대화의 QOS에 영향을 미치지 않습니다.

구문

BOOL DdeSetQualityOfService(
  [in]  HWND                              hwndClient,
  [in]  const SECURITY_QUALITY_OF_SERVICE *pqosNew,
  [out] PSECURITY_QUALITY_OF_SERVICE      pqosPrev
);

매개 변수

[in] hwndClient

형식: HWND

DDE 대화를 시작하기 위해 클라이언트가 보낼 WM_DDE_INITIATE 메시지의 원본을 지정하는 DDE 클라이언트 창에 대한 핸들입니다.

[in] pqosNew

형식: const SECURITY_QUALITY_OF_SERVICE*

원하는 서비스 품질 값에 대한 SECURITY_QUALITY_OF_SERVICE 구조체에 대한 포인터입니다.

[out] pqosPrev

형식: PSECURITY_QUALITY_OF_SERVICE

hwndClient로 식별된 창과 연결된 이전 서비스 품질 값을 수신하는 SECURITY_QUALITY_OF_SERVICE 구조체에 대한 포인터입니다.

이 매개 변수는 선택적 요소입니다. 애플리케이션이 hwndClient의 이전 QOS 값에 관심이 없는 경우 pqosPrev 를 NULL로 설정해야 합니다.

반환 값

형식: BOOL

함수가 성공하면 반환 값이 0이 아닙니다.

함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

설명

wParam이 hwndClient로 설정된 WM_DDE_INITIATE 보내기 전에 클라이언트 창 hwndClient에 대해 서비스 품질이 지정되지 않은 경우 시스템은 클라이언트 창에 다음과 같은 기본 서비스 품질 값을 사용합니다.

{ 
   Length = sizeof(SECURITY_QUALITY_OF_SERVICE); 
   ImpersonationLevel = SecurityImpersonation; 
   ContextTrackingMode = SECURITY_STATIC_TRACKING; 
   EffectiveOnly = TRUE; 
}

DdeSetQualityOfService 함수를 사용하여 다른 서비스 품질을 클라이언트 창과 연결합니다. 서비스 품질을 변경한 후 새 설정은 시작된 후속 대화에 영향을 미칩니다. 애플리케이션이 특정 서비스 품질 값을 사용하여 DDE 대화를 시작하면 다른 값을 적용하려면 대화를 종료하고 대화를 다시 시작해야 합니다.

요구 사항

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