


DXmCvtOStoCS(3X)					     DXmCvtOStoCS(3X)



NAME
  DDXXmmCCvvttOOSSttooCCSS - Converts a string in the operating-system-specific format to
  a compound string.

SYNOPSIS

  XXmmSSttrriinngg DDXXmmCCvvttOOSSttooCCSS	((_o_s__s_t_r_i_n_g,, _b_y_t_e__c_o_u_n_t,,	_s_t_a_t_u_s))
	    OOppaaqquuee  _o_s__s_t_r_i_n_g;;
	    lloonngg    **_b_y_t_e__c_o_u_n_t;;
	    lloonngg    **_s_t_a_t_u_s;;

PARAMETERS

  _o_s__s_t_r_i_n_g
      A	pointer	to the input string.

  _b_y_t_e__c_o_u_n_t
      The number of bytes in the length	of the output string.

  _s_t_a_t_u_s
      The status of the	conversion procedure, indicated	by one of the follow-
      ing values:


      _______________________________________________

      Value		     Description

      _______________________________________________

      DXmCvtStatusOK

			     The conversion was	suc-
			     cessful.

      DXmCvtStatusDataLoss

			     Data was lost during the
			     conversion.

      DXmCvtStatusFail

			     The conversion was	not
			     successful.

      _______________________________________________

DESCRIPTION

  The DDXXmmCCvvttOOSSttooCCSS routine converts a string in	the operating-system-specific
  format to a compound string.	The user must free the string by using the
  Toolkit routine XXmmSSttrriinnggFFrreeee.

RETURN VALUES

  A pointer to the compound string.









