ICELIB0.NLM   →   ICE_ConvertASCIIToDNS()

ICE_ConvertASCIIToDNS

Description:

Converts an ASCIIZ hostname to the format required by the DNS protocol.
 

Syntax for C:

void *ICE_ConvertASCIIToDNS (
  char *string,
  unsigned int flags
);
 

Syntax for Assembly:

Call ICE_ConvertASCIIToDNS C, offset string, [flags]
 

Parameters:

string

(IN) Points to the null-terminated string containing the ASCIIZ hostname to be converted.
 

flags

(IN) Some rules to be enforced during conversion.  All undocumented bit flags are considered reserved for future use, and should remain cleared (0) to ensure upward compatibility with newer versions of ICELIB0.NLM.  Currently supported flags are as follows:

No flags present.
 

Returns:

Pointer to buffer (created by malloc()) that holds the converted DNS string.

0 = No buffer created
 

Remarks:

Destination string will be one byte longer than source because an extra byte is needed for a preceeding length byte.

Dots (periods) are used to identify the length of each element in the DNS name, for example (where literal byte values are enclosed in square brackets):

Source = www.inter-corporate.com[0]
Destination = [3]www[15]inter-corporate[3]com[0]

Remember to use NetWare's free() function when you no longer need the string.
 

Resource files:

icelib0.imp