GetFullPathNameTransactedA 함수(winbase.h)

[Microsoft는 개발자가 애플리케이션의 요구 사항을 달성하기 위해 대체 수단을 활용하는 것이 좋습니다. TxF가 개발된 많은 시나리오는 더 간단하고 쉽게 사용할 수 있는 기술을 통해 달성할 수 있습니다. 또한 이후 버전의 Microsoft Windows에서는 TxF를 사용할 수 없습니다. 자세한 내용 및 TxF에 대한 대안은 트랜잭션 NTFS사용에 대한 대안을 참조하세요.

지정된 파일의 전체 경로 및 파일 이름을 트랜잭션 작업으로 검색합니다.

트랜잭션 없이 이 작업을 수행하려면 GetFullPathName 함수를 사용합니다.

파일 및 경로 이름에 대한 자세한 내용은 파일 이름, 경로 및 네임스페이스참조하세요.

통사론

DWORD GetFullPathNameTransactedA(
  [in]  LPCSTR lpFileName,
  [in]  DWORD  nBufferLength,
  [out] LPSTR  lpBuffer,
  [out] LPSTR  *lpFilePart,
  [in]  HANDLE hTransaction
);

매개 변수

[in] lpFileName

파일의 이름입니다.

이 문자열은 짧은(8.3 형식) 또는 긴 파일 이름을 사용할 수 있습니다. 이 문자열은 공유 또는 볼륨 이름일 수 있습니다.

파일은 로컬 컴퓨터에 있어야 합니다. 그렇지 않으면 함수가 실패하고 마지막 오류 코드가 ERROR_TRANSACTIONS_UNSUPPORTED_REMOTE.

[in] nBufferLength

TCHAR드라이브 및 경로에 대해 null로 끝나는 문자열을 받을 버퍼의 크기입니다.

[out] lpBuffer

드라이브 및 경로에 대해 null로 끝나는 문자열을 수신하는 버퍼에 대한 포인터입니다.

[out] lpFilePart

경로에 있는 최종 파일 이름 구성 요소의 주소(lpBuffer)를 수신하는 버퍼에 대한 포인터입니다. 이 정보를 받을 필요가 없는 경우 NULL 지정합니다.

lpBuffer 파일이 아닌 디렉터리를 가리키는 경우 lpFilePart 0을 받습니다.

[in] hTransaction

트랜잭션에 대한 핸들입니다. 이 핸들은 CreateTransaction 함수에서 반환됩니다.

반환 값

함수가 성공하면 반환 값은 종료 null 문자를 포함하지 않고 lpBuffer복사된 문자열의 길이(TCHAR)입니다.

lpBuffer 버퍼가 너무 작아서 경로를 포함할 수 없는 경우 반환 값은 경로 및 종료 null 문자를 보유하는 데 필요한 버퍼의 크기(TCHAR)입니다.

다른 이유로 인해 함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 얻으려면 GetLastError호출합니다.

발언

GetFullPathNameTransacted 현재 드라이브 및 디렉터리의 이름을 지정된 파일 이름과 병합하여 지정된 파일의 전체 경로 및 파일 이름을 확인합니다. 또한 전체 경로 및 파일 이름의 파일 이름 부분 주소를 계산합니다. 이 함수는 결과 경로 및 파일 이름이 유효한지 또는 연결된 볼륨에 기존 파일이 표시되는지 확인하지 않습니다.

공유 및 볼륨 이름은 lpFileName유효한 입력입니다. 예를 들어 test-2가 원격 컴퓨터이고 U인 경우 다음 목록 ID는 반환된 경로 및 파일 이름을 ID로 지정합니다.

• "\\test-2\q$\lh"를 지정하면 반환되는 경로는 "\\test-2\q$\lh"입니다.
• "\\?\UNC\test-2\q$\lh"를 지정하면 반환되는 경로는 "\\?\UNC\test-2\q$\lh"입니다.
• "U:"를 지정하면 반환되는 경로가 "U:\"입니다.