TranslateURLA 함수(intshcut.h)

아티클
02/28/2024

지정된 URL 문자열에 일반 번역을 적용하여 새 URL 문자열을 만듭니다.

구문

INTSHCUTAPI HRESULT TranslateURLA(
        PCSTR pcszURL,
        DWORD dwInFlags,
  [out] PSTR  *ppszTranslatedURL
);

매개 변수

pcszURL

형식: PCTSTR

번역할 URL 문자열의 주소입니다.

dwInFlags

형식:DWORD

URL 문자열을 변환하는 방법을 지정하는 비트 플래그입니다. 이 값은 다음의 조합일 수 있습니다.

TRANSLATEURL_FL_GUESS_PROTOCOL

프로토콜 체계가 pcszURL 매개 변수에서 TranslateURL로 지정되지 않은 경우 시스템은 자동으로 스키마를 선택하고 URL에 추가합니다.

TRANSLATEURL_FL_USE_DEFAULT_PROTOCOL

프로토콜 체계가 pcszURL 매개 변수에서 TranslateURL에 지정되지 않은 경우 시스템은 URL에 기본 프로토콜을 추가합니다.

[out] ppszTranslatedURL

형식: PTSTR*

새로 만든 번역된 URL 문자열(있는 경우)에 대한 포인터를 수신하는 포인터 변수입니다. ppszTranslatedURL 매개 변수는 함수가 S_OK 반환하는 경우에만 유효합니다.

반환 값

형식: HRESULT

성공 시 S_OK 반환하거나 URL에 번역이 필요하지 않은 경우 S_FALSE. 오류가 발생하면 함수는 다음 값 중 하나를 반환합니다.

반환 코드	설명
E_FLAGS	dwInFlags에 전달된 플래그 조합이 잘못되었습니다.
E_OUTOFMEMORY	작업을 완료할 메모리가 부족했습니다.
E_POINTER	입력 포인터 중 하나가 잘못되었습니다.

설명

이 함수는 입력 URL 문자열의 유효성을 검사하지 않습니다. 반환 값이 성공한다고 해서 URL 문자열이 유효한 URL임을 나타내지는 않습니다.

참고

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

요구 사항

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

Share via