IMultiLanguage2::DetectInputCodepage Method

---

Detects the code page of the given string.

Syntax

HRESULT DetectInputCodepage(
    DWORD dwFlag,
    DWORD dwPrefWinCodePage,
    CHAR *pSrcStr
    UINT *pcSrcSize,
    DetectEncodingInfo *lpEncoding,
    INT *pnScores,
);

Parameters

dwFlag

[in] One of the MLDETECTCP-defined bit flag values that specify the type of incoming source text. Setting the bit flags helps the detection engines produce more accurate results.

dwPrefWinCodePage

[in] Preferred Windows® code page. If this value is set to zero, this API returns all possible encodings. Otherwise, it lists only those encodings related to this parameter.

pSrcStr

[in] Source string for which the client wants to detect the code page.

pcSrcSize

[in, out] Address of the buffer that stores the size of pSrcStr, in bytes. When this method is successful, it returns the number of bytes processed to this buffer.

lpEncoding

[in, out] Address of an array of DetectEncodingInfo structures where the detection information will be returned.

pnScores

[in, out] Address of a buffer that contains the number of DetectEncodingInfo structures allocated in lpEncoding. When this method is successful, this parameter returns the number of elements of lpEncoding that have been filled in.

Return Value

Returns one of the following values:

S_OK	Success.
S_FALSE	The method cannot determine the code page of the input stream.
E_FAIL	An error occurred.

Remarks

The caller is responsible for allocating and freeing the lpEncoding array.

See Also

IMultiLanguage2::DetectCodepageInIStream