SWbemDateTime.GetFileTime 메서드

SWbemDateTime 개체의 GetFileTime 메서드는 CIM DATETIME 형식의 날짜 및 시간 값을 FILETIME 형식으로 변환합니다.

매개 변수가 TRUE로 설정된 경우 반환 값은 클라이언트의 로컬 시간을 나타냅니다. 그렇지 않으면 반환 값은 UTC(협정 세계시) 시간입니다. FILETIMEDATETIME 구조는 1601년 1월 1일 이후의 100나노초 단위 수를 나타내는 64비트 값입니다. WMI(Windows Management Instrumentation)는 FILETIME 값을 부호 없는 64비트 숫자의 문자열 표현으로 처리합니다.

이 구문에 대한 설명은 스크립팅 API의 문서 규칙을 참조하세요.

구문

vDate = .GetFileTime( _
  [ ByVal bIsLocaL ] _
)

매개 변수

bIsLocaL [in, optional]

반환된 값이 현지 시간으로 해석되는지 여부를 나타냅니다. 그러면 UTC 속성에 올바른 UTC(협정 세계시) 오프셋으로 변환된 현지 시간이 포함됩니다. 값이 FALSE이면 값이 0인 오프셋이 있는 UTC로 해석됩니다.

반환 값

FILETIME 형식의 날짜 및 시간입니다.

오류 코드

GetFileTime 메서드를 완료한 후 Err 개체에 아래 목록의 오류 코드가 포함될 수 있습니다.

wbemErrFailed - 2147749889 (0x80041001)

호출이 실패한 경우

설명

VT_DATE 및 FILETIME 값은 와일드카드 필드를 포함할 수 없습니다.

다음 속성 중 하나가 FALSE인 경우 GetFileTime 메서드는 실패합니다(wbemErrFailed).

• YearSpecified
• MonthSpecified
• DaySpecified
• HoursSpecified
• MinutesSpecified
• SecondsSpecified
• MicrosecondsSpecified
• UTCSpecified

SetFileTime에서 성공적으로 반환되면 모든 속성이 TRUE로 설정됩니다.

예제

SWbemDateTime 개체를 사용하여 CIM DATETIME 값을 FILETIME 형식 또는 VT_DATE 형식으로 변환하는 예제를 보려면 WMI 작업: 날짜 및 시간을 참조하세요. CIM DATETIME 형식에 대한 설명은 날짜 및 시간 형식을 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista
지원되는 최소 서버	Windows Server 2008
헤더	Wbemdisp.h
유형 라이브러리	Wbemdisp.tlb
DLL	Wbemdisp.dll
CLSID	CLSID_SWbemDateTime
IID	IID_ISWbemDateTime

추가 정보

SWbemDateTime.GetVarDate

SWbemDateTime

DATETIME