URLAssociationDialogA 함수(intshcut.h)

아티클
02/26/2024

등록되지 않은 URL 프로토콜 대화 상자를 호출합니다. 이 대화 상자를 사용하면 사용자가 이전에 알려지지 않은 프로토콜과 연결할 애플리케이션을 선택할 수 있습니다.

참고 Windows XP SP2(서비스 팩 2) 이상: 이 함수는 더 이상 지원되지 않습니다.

구문

INTSHCUTAPI HRESULT URLAssociationDialogA(
        HWND  hwndParent,
        DWORD dwInFlags,
        PCSTR pcszFile,
        PCSTR pcszURL,
  [out] PSTR  pszAppBuf,
        UINT  ucAppBufLen
);

매개 변수

hwndParent

형식: HWND

부모 창에 대한 핸들입니다.

dwInFlags

형식:DWORD

함수의 동작을 지정하는 비트 플래그입니다. 이 값은 다음의 조합일 수 있습니다.

URLASSOCDLG_FL_USE_DEFAULT_NAME

기본 파일 이름(즉, "인터넷 바로 가기")을 사용합니다.

URLASSOCDLG_FL_REGISTER_ASSOC

선택한 애플리케이션을 pcszURL에 지정된 프로토콜의 처리기로 등록합니다. 이 플래그가 설정되고 사용자가 영구 연결을 원하는 경우에만 애플리케이션이 등록됩니다.

pcszFile

형식: PTCSTR

URL 프로토콜과 연결할 파일 이름을 포함하는 상수 0으로 끝나는 문자열의 주소입니다.

pcszURL

형식: PTCSTR

알 수 없는 프로토콜이 있는 URL을 포함하는 상수 0으로 끝나는 문자열의 주소입니다.

[out] pszAppBuf

형식: PTSTR

사용자가 지정한 애플리케이션의 경로를 수신하는 버퍼의 주소입니다.

ucAppBufLen

형식: UINT

pszAppBuf의 크기(문자)입니다.

반환 값

형식: HRESULT

참고 Windows XP SP2를 기준으로 이 함수는 지원되지 않으며 모든 상황에서 E_NOTIMPL 반환합니다.

지원되는 시스템에서 는 애플리케이션이 URL 프로토콜에 등록된 경우 S_OK 반환하고, 등록되지 않은 경우 S_FALSE 반환합니다. 예를 들어 함수는 사용자가 선택한 애플리케이션을 통해 일회성 실행을 수행하기로 선택할 때 S_FALSE 반환합니다.

설명

참고

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

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	intshcut.h
DLL	Url.dll

다음을 통해 공유