다음을 통해 공유

IAmsiStream::GetAttribute 메서드(amsi.h)

  • 아티클

스트림에서 요청된 특성을 반환합니다.

구문

HRESULT GetAttribute(
  [in]  AMSI_ATTRIBUTE attribute,
  [in]  ULONG          dataSize,
  [out] unsigned char  *data,
  [out] ULONG          *retData
);

매개 변수

[in] attribute

반환할 특성의 형식을 지정합니다. 설명 부분을 참조하세요.

[in] dataSize

출력 버퍼의 크기( 데이터)(바이트)입니다.

[out] data

요청된 특성을 받을 버퍼입니다. 데이터는 해당 크기(바이트)로 설정해야 합니다.

[out] retData

데이터에 반환된 바이트 수입니다. 이 메서드가 E_NOT_SUFFICIENT_BUFFER 반환하는 경우 retData 에는 필요한 바이트 수가 포함됩니다.

반환 값

이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.

반환 코드 Description
S_OK
 성공.
E_NOTIMPL
 특성은 지원되지 않습니다.
E_NOT_SUFFICIENT_BUFFER
 데이터에 표시된 대로 출력 버퍼의 크기가 충분히 크지 않습니다. retData 에는 필요한 바이트 수가 포함됩니다.
E_INVALIDARG
 하나 이상의 인수가 잘못되었습니다.
E_NOT_VALID_STATE
 개체가 초기화되지 않았습니다.

설명

특성에서 요청된 특성에 따라 다음 데이터를 데이터에 복사해야 합니다.

attribute data
AMSI_ATTRIBUTE_APP_NAME LPWSTR에서 복사한 호출 애플리케이션의 이름, 버전 또는 GUID 문자열입니다.
AMSI_ATTRIBUTE_CONTENT_NAME LPWSTR에서 복사한 파일 이름, URL, 고유 스크립트 ID 또는 유사한 콘텐츠입니다.
AMSI_ATTRIBUTE_CONTENT_SIZE ULONGLONG으로 입력의 크기입니다.
AMSI_ATTRIBUTE_CONTENT_ADDRESS 콘텐츠가 메모리에 완전히 로드된 경우의 메모리 주소입니다.
AMSI_ATTRIBUTE_SESSION 세션은 검사할 내용이 동일한 원래 스크립트에 속하는 경우와 같이 다양한 검사 호출을 연결하는 데 사용됩니다. 콘텐츠가 자체 포함된 경우 nullptr 을 반환합니다.

요구 사항

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

추가 정보

AMSI_ATTRIBUTE

IAmsiStream